com.eignex.koblas/sparse/host/umfpack/[jvm]UmfpackFactorization

UmfpackFactorization

class UmfpackFactorization : F64SparseFactorization(source)

Holds matrix alive because umfpack_di_solve takes Ap, Ai and Ax alongside the factors, and releases the factors, which are UMFPACK's own allocation, through nativeCleaner once this object is unreachable.

Properties

failedAt

open override val failedAt: Int(source)

The pivot position that had no numerically acceptable candidate, or NOT_SINGULAR when the factorization succeeded.

n

open override val n: Int(source)

The dimension of the factored matrix.

nnz

open override val nnz: Int(source)

Nonzeros in the factors, the fill. Zero for a singular factorization, which has none.

rcond

open override var rcond: Double(source)

A cheap pivot-quality estimate: min(abs(U(k, k))) / max(abs(U(k, k))). A small value warns that the factorization may be inaccurate; it is not a reciprocal condition-number estimate.

singular

open val singular: Boolean

Whether the factorization failed for want of a numerically acceptable pivot. Solving against one throws com.eignex.koblas.SingularMatrix rather than answering with infinities.

Functions

solveInto

open override fun solveInto(b: DoubleArray, out: DoubleArray, transpose: Boolean = false, workspace: Workspace? = null): DoubleArray(source)

Solve B x = b, or Bᵀ x = b when transpose, into out, which is returned. Allocates nothing when given a workspace. out may be b.

solve

open fun solve(b: DoubleArray, transpose: Boolean = false): DoubleArray

Solve B x = b, or Bᵀ x = b when transpose, into a fresh result.